home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / sfind.arc / SFIND.DOC < prev   
Text File  |  1987-01-28  |  6KB  |  151 lines
  1. SFind.doc - This file must accompany SFind.com when SFind is copied.
  2.  
  3. SuperFind 1.00 Copyright (C) Tony Overfield 1987.
  4. All rights reserved.  For non-commercial use only.
  5.  
  6. Usage:  SFind [d:]filename.ext [/n] [/p]
  7.         [d:]         - optional drive letter
  8.         filename.ext - required file specification
  9.         [/n]         - optionally omit .ARC searching
  10.         [/p]         - pause when screen is full
  11.  
  12. This program searches the entire drive for files that match the
  13. specification given.  The wildcards * and ? are permitted.
  14.  
  15. Sfind will also search all .ARC files on the drive for the specified file,
  16. unless the /n parameter is present.
  17.  
  18. You may copy and distribute the SFind program freely, provided that it is
  19. distributed only in its original, unmodified state, and with its
  20. accompanying documentation file(this file).
  21.  
  22. Purpose:
  23.    I wrote SuperFind to help me locate files on my hard disk after
  24. having previously combined them into .ARC files.  Whenever my hard
  25. disk becomes nearly full, and I need some space for other files, I
  26. usually combine the entire contents of a particular subdirectory
  27. into one file to gain the required amount of space.  Over time,
  28. this process has resulted in numerous .ARC files on my hard disk,
  29. each representing many different files.  Then it happens: I need
  30. to find a particular file and I just KNOW that it is on my hard
  31. disk somewhere, but I don't know where.  I tried all the file finding
  32. programs I could find, but none of them would look inside my .ARC
  33. files.  That is why I wrote SuperFind.  I needed a FAST method of
  34. locating files even if they were enclosed within a .ARC file.
  35.  
  36. Result:
  37.    I wrote SuperFind in assembly language for maximum speed and
  38. small size (less than 3k).  Nobody wants a program that is
  39. unreasonably large or unnecessarily slow.  The result is a carefully
  40. designed program, with much effort engaged in achieving maximum
  41. speed and minimum size. SuperFind does not have bells and whistles.
  42. It simply does its job as rapidly as possible, and takes up very
  43. little space.
  44.  
  45. Operation:
  46.    SuperFind reads all of the directories on the specified disk in
  47. its attempt to find the specified file.  If a file with the extension
  48. .ARC is found during the search, then it is also checked for the file.
  49. The option /n will save you some time if you know that the file is
  50. not in a .ARC file.  The amount of time saved depends on the number
  51. and size of the .ARC files on the specified drive.  The /p parameter
  52. causes SuperFind to pause and wait for a key when the screen is full.
  53.  
  54. Output:
  55.    When you run SuperFind, you will see output similar to the output
  56. below.
  57.  
  58.    First is the title line, indicating the program and version.
  59. The next line tells you where the program will be searching and the
  60. file specification that it is looking for.
  61.  
  62.    When files are found they will be displayed in one of two ways.
  63.  
  64.    Files that are found in a normal directory are indicated with a
  65.    "-" and then the name of the directory in which the file was found.
  66.  
  67.    Files that are found in a .ARC file are indicated with a ">" and
  68.    the full pathname of the .ARC file that contains the file.
  69.  
  70. Sample Output:
  71.    The command given to dos for this example was:
  72.  
  73. C>sfind s*.asm
  74. -------------------------- SuperFind output begins
  75.  
  76. SFind  Version 1.00, 01-28-87
  77.  
  78. Searching drive C: for [S???????.ASM]
  79.  
  80. SFIND.ASM    - C:\ASMS\
  81. SPOOL.ASM    - C:\ASMS\
  82. SFIND.ASM    > C:\ASMS\BACKUPS.ARC
  83.  
  84. 3 file(s) found
  85.  
  86. -------------------------- SuperFind output ends
  87.  
  88. This output shows that the files SFIND.ASM and SPOOL.ASM were found in
  89. a directory called C:\ASMS, and SFIND.ASM was also found inside a .ARC
  90. file called BACKUPS.ARC that was also in the directory called C:\ASMS.
  91.  
  92.  
  93. Running SuperFind:
  94.  
  95.    If you want to find a file called "program.asm", just enter:
  96.  
  97.       SFind program.asm
  98.  
  99.    If you want to search another drive (C: for example), just enter:
  100.  
  101.       SFind c:program.asm
  102.  
  103.    If you want to find the file without searching .ARC files, just enter:
  104.  
  105.       SFind program.asm /n
  106.  
  107.    The following examples are all valid:
  108.  
  109.       SFind b:program.asm /n
  110.       SFind prog*.asm
  111.       SFind d:prog*.a*
  112.       SFind *.*
  113.  
  114. Version 2.00 (coming in March '87):
  115.    New features that will be incorporated into version 2.00 are:
  116.    o  Support for searching .LBR files, including sQueezed files
  117.    o  Additional listing options
  118.    o  Any reasonable request from users of version 1.00
  119.  
  120.    I will send version 2.00 to anyone who sends me $5 for my trouble.
  121.  
  122. Warranty:
  123.    I have attempted to make this program work as represented, and to the
  124. best of my knowledge it does.  I will not, however, take any responsibility
  125. for any problems that may occur when using this program.
  126.  
  127. Licensing:
  128.    You may copy and distribute the SFind program freely, provided that it
  129. is distributed only in its original, unmodified state, and with its
  130. accompanying documentation file(this file).
  131.  
  132.    Commercial users must contribute $5 for continued use of this program.
  133.  
  134.    This program is "Supper-Ware".  If you feel this program is worth buying
  135. me supper, then send me a check($5-$10), and I'll treat myself.
  136. This contribution is completely voluntary.
  137.  
  138. (By the way, I've been told that about one in a thousand people actually
  139. contribute.  So, if five thousand people like and use this program, I
  140. might make a whopping $25!)
  141.  
  142.    I wrote this program to fulfill a need that I perceived, and it
  143. has served me well.  If you like this program, and you want to send
  144. me a donation, you should feel free to do so.
  145.  
  146. Please send comments and/or donations to:
  147.   Tony Overfield
  148.   P.O. Box 3666
  149.   College Station, TX  77843
  150.  
  151.